home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / utility1 / hgopher.zip / README.TXT < prev   
Text File  |  1993-06-03  |  12KB  |  330 lines
  1.           README for HGOPHER (Hampson's Gopher) 
  2.  
  3.     A Gopher Client For Windows 3.1  Version Beta 1.0
  4.  
  5.     Please read the Copyright notices at the end of this document
  6.  
  7. Welcome
  8.  
  9. Here is a Gopher Client for windows 3.1.
  10. Note this is an Beta test release and as such the documentation
  11. and online help is poor.
  12.  
  13. However if you would like to try it feel free and have fun!
  14.  
  15. Send comments or problems to m.hampson@ic.ac.uk
  16. If you find this product useful please let me know
  17. as it gives me the will to continue.
  18.  
  19. Changes since Alpha Release
  20.  
  21.     * Winsock version is now available
  22.     * Product has been renamed since gopher was a bit
  23.       generic - for want of anything better I am now 
  24.       calling in Hampson's Gopher or hgopher.
  25.     * Telnet now spawned with IP address rather than
  26.       host name (for systems without DNS)
  27.     * Book marks can now be edited and created. This
  28.       allows you to build your own gopher items
  29.  
  30. Requirements
  31.     
  32.     WINSOCK VERSION
  33.  
  34.     * MS Windows 3.1  (not tested with Windows 3.0)
  35.       Or Windows NT.
  36.     * Winsock DLL and TCP/IP+Packet support layer.
  37.     * See later for a list of Winsock tested versions.
  38.  
  39.     PC NFS VERSION
  40.     
  41.     * MS Windows 3.1 (not tested with Windows 3.0)
  42.     * PC NFS Version 4 or version 5 (may work with other versions)
  43.           NOTE: you can also use the Winsock version with PC NFS 5.0
  44.                 and I suggest you do, as support for the native PC NFS
  45.                 version may be withdrawn at some point.
  46.  
  47.  
  48. Features
  49.  
  50.     * Bookmarks with editing 
  51.     * DNS capability
  52.     * Vendor name lookup capability
  53.     * Text, image, telnet, tn3270 capability
  54.           (providing you have other public domain or PC NFS products)
  55.     * Index capability
  56.     * copy to file capability
  57.     
  58.     * No CSO support yet
  59.     * No Sound support yet
  60.     * No PostScript support yet (although I looks like it does)
  61.     * No MIME support yet
  62.  
  63.  
  64. Installation
  65.  
  66.     Available for ANON FTP from lister.cc.ic.ac.uk
  67.     Change to directory pub/wingopher and collect the files
  68.  
  69.     readme.txt
  70.     hgopher.exe   [Winsock Version]      (Binary mode required)
  71.     hngopher.exe  [Sun PC NFS Version]   (Binary mode required)
  72.  
  73.     Then read the readme.txt file (This file)
  74.  
  75.     copy the  executable file to where ever you keep binaries
  76.     create a program item for in from Program Manager (if you like)
  77.     Execute it
  78.  
  79. Troubleshooting
  80.     
  81.     WINSOCK VERSION
  82.  
  83.     The first time you start it hgopher may not be able to 
  84.     connect to a server or will probably connect to the wrong
  85.     server
  86.     Use the Options menu to config it as follows
  87.  
  88.     Gopher Options
  89.     
  90.     Set the name and path of your favorite gopher server
  91.     Change the viewers to the viewers of your choice 
  92.     (Note that PostScript does not work yet)
  93.     The default text viewer "notepad" can only view small
  94.     files - change to write or something else if you wish to
  95.     view larger files.
  96.  
  97.     Select a directory for temp files that already exists
  98.  
  99.     Hit the save button to save these setting between sessions
  100.     Hit the OK button to use these setting now
  101.  
  102.     use "go home" from the command menu to get the main menu 
  103.     from your default gopher.
  104.  
  105.     Network setup
  106.     
  107.     Set whether you are using DNS or the Vendor look up
  108.     service - If your vendor supports DNS lookup themselves
  109.     I suggest you use their service as the inbuilt DNS has
  110.     been shown not to work on some (most) Winsock versions. 
  111.  
  112.     If you are using the Winsock version with PC NFS you must
  113.         use the inbuilt DNS as Sun have not only not bothered to
  114.     implement DNS support but their own NIS does not function
  115.     with their Winsock either (at least at the release level
  116.     I have).
  117.     
  118.     If using the inbuilt DNS remember to use IP addresses and
  119.     not host names.
  120.  
  121.     PC NFS VERSION
  122.  
  123.     Make sure at least RTM is loaded before you start Windows
  124.  
  125.     The first time you start it hngopher may not be able to 
  126.     connect to a server or will probably connect to the wrong
  127.     server
  128.     Use the Options menu to config it as follows
  129.  
  130.     Gopher Options
  131.     
  132.     Set the name and path of your favorite gopher server
  133.     Change the viewers to the viewers of your choice 
  134.     (Note that PostScript does not work yet)
  135.     The default text viewer "notepad" can only view small
  136.     files - change to write or something else if you wish to
  137.     view larger files.
  138.  
  139.     Select a directory for temp files that already exists
  140.  
  141.     Hit the save button to save these setting between sessions
  142.     Hit the OK button to use these setting now
  143.  
  144.     use "go home" from the command menu to get the main menu 
  145.     from your default gopher.
  146.  
  147.     Network setup
  148.     
  149.     Set whether you are using DNS or the Vendor name lookup
  150.     - with Sun this is NIS  - DNS is better.
  151.     Add up to 3 local DNS servers and your local domain
  152.     Hit OK. Remember to use IP addresses not hostnames.
  153.  
  154.  
  155. Usage
  156.  
  157.     I am assuming its pretty easy to use (Sorry!) - but here
  158.     are some of the non obvious function
  159.  
  160.  
  161.     To fetch an item double click on it
  162.     To get to the previous item - double click previous item
  163.     You can highlight an item with a single click and explicitly
  164.     fetch it from the command menu (previous is also a command
  165.     menu item) or save it as a book mark
  166.     
  167.     While fetching an item a transfer state button appears
  168.     giving the connection status. While waiting to connect
  169.     windows freezes (this is not true of the Winsock version
  170.         in that case just this application is busy) 
  171.         during the transfer
  172.     windows should behave normally. You can click on this
  173.     button to abort the transfer. You can have up to 3 
  174.     transfers going but only the last is active.
  175.  
  176.     History (command menu) shows you where you have been
  177.     Flip (command menu) or right hand mouse button takes
  178.     you back to the main menu. Flip or right hand mouse button
  179.     from the main menu takes you to the bookmark menu.
  180.     you can load and save bookmarks to files - You can also
  181.     select a bookmark file to load on startup.
  182.  
  183.     Menu's are cached - default time 10 minutes you can change
  184.     this from gopher options
  185.  
  186.     
  187. Winsock implementations tested against
  188.  
  189. Thanks to alot of help from my Alpha testers on the Net I have
  190. been able to verify that the gopher works with several Winsock
  191. implementations. The state of play is as follows
  192.  
  193.     Lanera        - Verified to work
  194.     Distinct    - Verified to work
  195.     Netmange    - Believed to work
  196.     PC NFS 5.0      - Verified to work
  197.     PCTCP 2.11    - Verified to work
  198.     PCTCP 2.2    - Verified to work - However if you get a message
  199.               like PCTCPAPI052: get_kernel_info: Bad net_dope
  200.                           structure 0x1ae01197, try getting a newer version
  201.                   of their winsoc dll via ANON ftp
  202.               vax.ftp.com:/pub/winsockapi/FTPSoftware/winsock.dll.
  203.     SuperTcp 3.56   - Verified to work
  204.     Windows NT      - Verified to work under Beta version
  205.  
  206. If you find it works (or doesn't work) on a different Implementation 
  207. please let me know.
  208.  
  209. Known Bugs
  210.  
  211.  
  212.         Bug #2 ??? prefix for CSO object is incorrect
  213.         Bug #4 Problem co existing with Vista Exceed
  214.     Bug #5 Inbuilt DNS fails under some Winsock Implementations
  215.     Bug #6 Bombs sometimes if you exit while transfer of directory
  216.                in progress
  217.     Bug #7 Under Distinct - randomly crashes occasionally
  218.  
  219. Requests for Enhancements
  220. (lots - would be interested in feedback as to priority)
  221.  
  222.     Better GUI
  223.     Stop IDLE/RCV flashing in no data
  224.     On connection abort don't show data
  225.     ....
  226.  
  227. In the Pipe Line
  228.  
  229.     If there is enough interest in the product the following might 
  230.     happen.
  231.  
  232.     * CSO and other gopher types supported (do people really need CSO)
  233.     * News support
  234.     * A Decent displayer to replace notepad (Any out there)
  235.     * A groovier GUI
  236.     * True multi transfer capability
  237.     * Non blocking connects
  238.     * Online help
  239.     * Gopher+ features
  240.  
  241. ----------------------------------------------------------------------------
  242.     CopyRight notices 
  243.  
  244.     This version of gopher is not available in source code
  245.     form, however future versions maybe.
  246. ----------------------------------------------------------------------------
  247.  
  248.  * Copyright (c) 1993  Martyn Hampson
  249.  * All rights reserved.
  250.  *
  251.  * Redistribution and use in source and binary forms, with or without
  252.  * modification, are permitted provided that the following conditions
  253.  * are met:
  254.  * 1. Redistributions of source code must retain the above copyright
  255.  *    notice, this list of conditions and the following disclaimer.
  256.  * 2. Redistributions in binary form must reproduce the above copyright
  257.  *    notice, this list of conditions and the following disclaimer in the
  258.  *    documentation and/or other materials provided with the distribution.
  259.  * 3. All advertising materials mentioning features or use of this software
  260.  *    must display the following acknowledgement:
  261.  *    This product includes software developed by Martyn Hampson
  262.  * 4. The name Martyn Hampson
  263.  *    may NOT be used to endorse or promote products derived from this software
  264.  *    without specific prior written permission.
  265.  *
  266.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND
  267.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  268.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  269.  * ARE DISCLAIMED.  IN NO EVENT SHALL Martyn Hampson  BE LIABLE
  270.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  271.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  272.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  273.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  274.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  275.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  276.  * SUCH DAMAGE.
  277.  */
  278.  
  279. Some sections of the gopher code are modified versions of existing
  280. software. I include the copyright notices attached to that software below.
  281.  
  282. * The Resolver routines *
  283.  
  284. /*
  285.  * Copyright (c) 1985, 1988 Regents of the University of California.
  286.  * All rights reserved.
  287.  *
  288.  * Redistribution and use in source and binary forms, with or without
  289.  * modification, are permitted provided that the following conditions
  290.  * are met:
  291.  * 1. Redistributions of source code must retain the above copyright
  292.  *    notice, this list of conditions and the following disclaimer.
  293.  * 2. Redistributions in binary form must reproduce the above copyright
  294.  *    notice, this list of conditions and the following disclaimer in the
  295.  *    documentation and/or other materials provided with the distribution.
  296.  * 3. All advertising materials mentioning features or use of this software
  297.  *    must display the following acknowledgement:
  298.  *    This product includes software developed by the University of
  299.  *    California, Berkeley and its contributors.
  300.  * 4. Neither the name of the University nor the names of its contributors
  301.  *    may be used to endorse or promote products derived from this software
  302.  *    without specific prior written permission.
  303.  *
  304.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  305.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  306.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  307.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  308.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  309.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  310.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  311.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  312.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  313.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  314.  * SUCH DAMAGE.
  315.  */
  316.  
  317. * Misc utility routines (from Xgopher) *
  318.  
  319. * Allan Tuchman, University of Illinois at Urbana-Champaign     
  320. *                Computing and Communications Services Office   
  321. * Copyright 1992 by                                             
  322. *           the Board of Trustees of the University of Illinois 
  323. * Permission is granted to freely copy and redistribute this    
  324. * software with the copyright notice intact.                    
  325.  
  326.  
  327.  
  328.  
  329.  
  330.